home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mta_vf10.zip / MTMDOCEN.DOC < prev    next >
Text File  |  1992-05-03  |  23KB  |  502 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTM       Make Them Modified                  │    D.I.S.P.     │────┐
  3. ║                                               │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1992  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.10                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: 3th May 1992                        │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTM.EXE                                     |    └─────────────────┘
  12. ║ │                                             |       ┌─────┐        |
  13. ║ │                                             |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │ Lines starting with '│' are                 |     ┌────┴────┐      |
  16. ║ │ changes to release 15.08                    ------││││││ ═══│-------
  17. ║                                                     └─────────┘
  18. ╠═══════════════════════════════
  19. ║ Address: Robert W. van Hoeven
  20. ║          PO. Box 131
  21. ║          1170 AC  Badhoevedorp
  22. ║          Nederland / Holland
  23. ╚═══════════════════════════════
  24.  
  25.  ┌───────┬─────────────────────────────────────────────────────────────┐
  26.  │   0   │ Table of contents                                           │
  27.  └───────┴─────────────────────────────────────────────────────────────┘
  28.  
  29.  1 ---- General information
  30.   1.1   Copyrights and License Agreement
  31.   1.2   Newer versions and contacting the author
  32.  
  33.  2 ---- Package description and requirements
  34.   2.1   Preface
  35.   2.2   Requirements
  36.   2.3   History
  37.   2.4   Introduction & specs
  38.  
  39.  3 ---- Installation description
  40.   3.1   Installation
  41.   3.2   Remarks on archives
  42.   3.3   MTA/MTM.CTL
  43.   3.4   MTM touching
  44.   3.5   Aborting MTM
  45.  
  46.  4 ---- Runtime information
  47.   4.1   Running MTM
  48.   4.2   Examples
  49.   4.3   (De)compressors
  50.   4.4   Encryption and Authenticity
  51.  
  52.  5 ---- Version information and credits
  53.   5.1   The BETA-team
  54.   5.2   Credits
  55.   5.3   Version history
  56.   5.4   Copyright, Trademarks
  57.  
  58.  ┌───────┬─────────────────────────────────────────────────────────────┐
  59.  │   1   │ General information                                         │
  60.  └───────┴─────────────────────────────────────────────────────────────┘
  61.  
  62.  1.1 Copyrights and License Agreement
  63.  ────────────────────────────────────
  64.  
  65.  - Users of the MTA-package must accept this disclaimer of warranty:
  66.  
  67.  - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
  68.    warranties, expressed or implied, including, without limitation,  the
  69.    warranties of merchantability  and of fitness  for any purpose.   The
  70.    author assumes  no liability  for damages,  direct or  consequential,
  71.    which may result from the use of the MTA-package;
  72.  
  73.  - The  MTA-package  is  a  "shareware  program"  and is provided at  no
  74.    charge to the user for evaluation.   Feel free to share it with  your
  75.    friends,  but  please  do  not  give  it  away  altered or as part of
  76.    another  system.   The  essence  of  "user-supported"  software is to
  77.    provide personal  computer users  with quality  software without high
  78.    prices, and yet to provide  incentive for programmers to continue  to
  79.    develop new products.
  80.  
  81.  - If  you find  this program  useful and  find that  you are  using and
  82.    continue the  use of  the MTA-package  after a  30 days trial period,
  83.    you must register the MTA-package as described below;
  84.  
  85.  - Non-commercial can get a license for the usage up to this release  of
  86.    the MTA-package for  a small amount  of money. Look  into the details
  87.    in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
  88.    reduction to upgrade to the  newer versions. These users should  look
  89.    into the details in UPGRADE.MTA.   For Non-commercial users there  is
  90.    a POSSIBILITY to submit to one of the special contracts as  explained
  91.    in the file REGISTER.MTA.
  92.  
  93.  - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
  94.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  95.    direct to the  SysOp to get  full access) is  has to pay  more than a
  96.    Non-commercial  user.  Both  types  of  users  should  look  into the
  97.    details in REGISTER.MTA;
  98.  
  99.  - The registration of the MTA-package will license ONE copy for use  on
  100.    any computer at any  one time, as long  as the usage confirms  to the
  101.    type of registration you have done (so NON-commercial usage when  you
  102.    have a non-commercial license);
  103.  
  104.  - Anyone  distributing  the  MTA-package  for any kind of remuneration
  105.    must  first   contact  the   Author   at   the  address   above   for
  106.    authorization.
  107.  
  108.  - You are  encouraged  to  pass a copy   of the MTA-package  along   to
  109.    your friends  for  evaluation.   Please  encourage  them to  register
  110.    their copy if they find that they can use it;
  111.  
  112.  - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
  113.    available  by  means  of  written  letters  or by entering the inter-
  114.    national echomail area DISP;
  115.  
  116.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  117.    conference <tm> called DISP (international). Entering this echo  does
  118.    not  exclude  you  of  the  duty  to register the MTA-package, though
  119.    users who evaluate the product can enter the echo for questions;
  120.  
  121.  - The  MTA-package, all  programs, the  documentation and support-files
  122.    is  copyrighted  1990,92  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  123.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  124.    this  package  for  backup  purposes.  Also  you  may  copy and share
  125.    unmodified copies of the whole package, providing that the  copyright
  126.    notice    is    reproduced    and    included    on    all    copies.
  127.    Excluded from this statement  are the support-files written  by other
  128.    authors.  Please  refer  to  the  documentation of these programs for
  129.    copyrights and license agreements;
  130.  
  131.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  132.    decompile  and/or  disassemble  the  software  in  the   MTA-package.
  133.    Patching the medium at  places that carry the  software is seen as  a
  134.    program change and is also forbidden. It is forbidden to create a  so
  135.    called 'bypass' to skip the original introduction screens and  delay.
  136.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  137.    author (Robert W. van Hoeven) himself;
  138.  
  139.  - Performing  any  of  the  illegal  actions as stated in the previous
  140.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  141.    important, to the registered users;
  142.  
  143.  - Bulletin Board  Systems that distribute  the MTA package  can convert
  144.    the WHOLE package  to any archive-system  they like but  all original
  145.    files must  be included  in the  new archive.  The MTA-package on the
  146.    Bulletin Board  can contain  at the  most 2  extra files. These files
  147.    can only be  a commercial for  that Bulletin Board  and/or validation
  148.    data that is presented  as a service to  all users and shall  have no
  149.    other functions;
  150.  
  151.  - After  the normal  trial period  of 30  days, you  must register  the
  152.    soft- ware (see REGISTER.MTA) or you must remove it from your PC;
  153.  
  154.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  155.    answered as soon I have the time  to do so. You can send me  a letter
  156.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  157.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  158.    Reinier de Groot).  When you want to send me normal mail, address  it
  159.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  160.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  161.    Echomail <tm> area;
  162.  
  163.  
  164.  1.2 Newer versions and contacting the author
  165.  ───────────────────────────────────────────────────────────────────────
  166.  The newest version of  MTA is always available  at the DISP-HQ on  node
  167.  2:512/100.  MTA  is  also  distributed  thru  a  number of DISP support
  168.  nodes.  There are three ways of obtaining newer versions of MTA:
  169.  
  170.  
  171.  - Logging on at DISP-HQ or a support node
  172.    Look into the file SUPPORT.MTA for a full list of support nodes;
  173.  
  174.  - Logging on to a SDS node
  175.    MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  176.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  177.    distribution point in Holland;
  178.  
  179.  - Logging on to your own BBS;
  180.    Chances  are,  that  you  will  find  an older version (international
  181.    users) because it will take some time for the new version to  'bleed'
  182.    thru the net;
  183.  
  184.  - Update service;
  185.    You can enter a special update service (read REGISTER.MTA).
  186.  
  187.  
  188.  If you think you have found problems in MTA, or in any other case,  you
  189.  wish to contact the author, you can send me:
  190.  
  191.  - A letter to the address you can find in the header of this file;
  192.  
  193.  - A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  194.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  195.  
  196.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  197.  
  198.  ┌───────┬─────────────────────────────────────────────────────────────┐
  199.  │   2   │ Package description and requirements                        │
  200.  └───────┴─────────────────────────────────────────────────────────────┘
  201.  
  202.  2.1 Preface
  203.  ───────────────────────────────────────────────────────────────────────
  204.  MTM  is  an  add-on  utility  for  MTA  and  is distributed in the same
  205.  release  archive  that   contains  MTA.  This   program  may)  NOT   be
  206.  distributed as a stand-alone package.
  207.  
  208.  
  209.  
  210.  2.2 Requirements
  211.  ───────────────────────────────────────────────────────────────────────
  212.  MTM requires:      - PC XT/AT/386
  213.                     - At least 320K free memory
  214.                     - DOS 3.xx (4.xx not tested)
  215.                       (also tested under 4Dos);
  216.                     - HDU optional
  217.  
  218.  
  219.  2.3 History
  220.  ───────────────────────────────────────────────────────────────────────
  221.  MTM is a little (grin) 'quick  and dirty' supplement to the 'good  old'
  222.  MTA program. This  program is just  for fun, but  there are some  BBS's
  223.  who would now 'kiss dutch ground'.
  224.  
  225.  MTM is a  simple archive manipulation  program for BBS  SysOp's. It can
  226.  do the following:
  227.  
  228.  - Delete specific files from  all archives (independent of the  archive
  229.    format);
  230.  
  231.  - Add  specific  files  to  all  archives  (independent of the  archive
  232.    format);
  233.  
  234.  - Remove headers from archives;
  235.  
  236.  - Add headers to archives;
  237.  
  238.  - Add and remove MTA mark-strings to archives without repacking;
  239.  
  240.  - Touch archives in the same way as MTA does;
  241.  
  242.  Why should you  want to use  these options you  ask. If you  are in the
  243.  habit of changing  your headers and  included files from  time to time,
  244.  this program is a simple way of doing all that work for you.
  245.  
  246.  The general scenario for using this program is:
  247.  
  248.  - You  have tons  of files,  piled up  in all  your directories and you
  249.    have included in any of these archives a file called U_READ.ME;
  250.  
  251.  - Now you want to change all the included files;
  252.  
  253.  - Also you  would like to  create an even  bigger header, because  your
  254.    users are not reaching their 'Leech limit' fast enough;
  255.  
  256.  - Without MTM, you are  gonna be busy for a  long time but with MTM  it
  257.    is easy;
  258.  
  259.  This scenario  could also  be played  with MTA,  but MTA  wants (it  is
  260.  written  for  this  function)  to  unpack  and pack all your compressed
  261.  files and will take up to 100^3  times the time MTM will take for  this
  262.  functions.
  263.  
  264.  ┌───────┬─────────────────────────────────────────────────────────────┐
  265.  │   3   │ Installation description                                    │
  266.  └───────┴─────────────────────────────────────────────────────────────┘
  267.  
  268.  
  269.  3.1 Installation
  270.  ───────────────────────────────────────────────────────────────────────
  271.  See the documentation for MTA (MTADOCEN.DOC).
  272.  
  273.  
  274.  3.2 Remarks on archives
  275.  ───────────────────────────────────────────────────────────────────────
  276.  MTM  will  only  support  normal  compressed  files. The extensions can
  277.  differ from the original extension  (e.g. TEST.SDS can be TEST.PAK  but
  278.  renamed). Abnormal  compressed files  are Self  Extraction files (SFX).
  279.  These will be ignored by MTM.
  280.  
  281.  
  282.  3.3 MTA/MTM.CTL
  283.  ───────────────────────────────────────────────────────────────────────
  284.  MTM will use some  of the MTA options.  In general all special  options
  285.  in MTA (exits,  CRC, Virus, includes  and so on)  are not used  but all
  286.  XXXPath option are used. Also  ZIPVersion and PAKVersion will be  used.
  287.  The same goes  for AutoDescription, IncludeFile  and ExcludeFile.   See
  288.  the MTADOCEN.DOC documentation  for those statements  that are used  by
  289.  MTM.
  290.  
  291.  
  292.  3.4 MTM touching
  293.  ───────────────────────────────────────────────────────────────────────
  294.  MTM will  preserve the  original file  date/time. This  is rather nice,
  295.  because users  will not  see these  files as  new-files after  you have
  296.  converted them with MTM. There  are options available to overrule  this
  297.  default behavior.
  298.  
  299.  
  300.  3.5 Aborting MTM
  301.  ───────────────────────────────────────────────────────────────────────
  302.  MTM will convert a complete directory (all compressed files). There  is
  303.  only one way  to abort MTM  (in this release)  and that is  by means of
  304.  the three-finger salute.
  305.  
  306.  ┌───────┬─────────────────────────────────────────────────────────────┐
  307.  │   4   │ Runtime Information                                         │
  308.  └───────┴─────────────────────────────────────────────────────────────┘
  309.  
  310.  4.1 Running MTM
  311.  ───────────────────────────────────────────────────────────────────────
  312.  The calling syntax of MTM is:
  313.  
  314.  MTM [filemask] {filemask]..{filemask} [options]
  315.  
  316.  If  no  filemask  is  available,  MTM  will  use  '*.*'  as the current
  317.  filemask. You can include up to 255 file-masks.
  318.  
  319.  [options] are one or  more (valid) command-line options.  The following
  320.  options are available:
  321.  
  322.  /DELMARK         Delete any current MTA mark-string;
  323.  
  324.  /ADDMARK         Add the new MTA-markstring to the selected files;
  325.  
  326.  /DELCOMMENT      Delete any ZIP-comment from the selected ZIP-archives;
  327.  
  328.  /ADDCOMMENT       Add  a new ZIP-comment  to the selected  ZIP-archives
  329.                   (only   if   AutoDescription    in   MTA/MTM.CTL    is
  330.                   available);
  331.  
  332.  /DELFILE         Delete  all    files  stated   in  the     MTA/MTM.CTL
  333.                   ExcludeFile option(s) from the selected archives;
  334.  
  335.  /ADDFILE         Add all  files stated in the MTA/MTM.CTL   IncludeFile
  336.                   option(s) to the selected archives;
  337.  
  338.  /TOUCHCUR        Touch archive based on current date;
  339.  
  340.  /TOUCHLOW        Touch archive based on lowest date inside archive;
  341.  
  342.  /TOUCHHIG        Touch archive based on highest date inside archive;
  343.  
  344.  /TOUCHNEW[dat]   Touch archive  with date  [dat]. [dat]  has format  of
  345.                   mmddyy;
  346.  
  347.  /DELAV           Force MTM to delete files even if the source   archive
  348.                   is AV protected;
  349.  
  350.  /W{path}         Let MTM use {path}. If not supplied, MTM will use  the
  351.                   current directory;
  352.  
  353.  /IOPpassword     Supply a password for encrypted files;
  354.  
  355.  /?               Displays a short help-screen;
  356.  
  357.  
  358.  4.2 Examples
  359.  ───────────────────────────────────────────────────────────────────────
  360.  - MTM *.ZIP *.PAK /DELCOMMENT /ADDMARK
  361.    Delete any comment from ZIP/PAK files and add a mark-string;
  362.  
  363.  - MTM *.* /DELMARK /DELFILE /DELCOMMENT
  364.    Cleans every file (ZIP/ZOO/PAK and so on) for comments, special
  365.    files and mark-strings;
  366.  
  367.  - MTM *.* /DELMARK /ADDMARK
  368.    This  will  delete  ANY  mark-string  and  add  yours.  If you select
  369.    /ADDMARK, MTM will assume /DELMARK by default;
  370.  
  371.  - MEM *.* /TOUCHNEW010192
  372.    Touch all ARCHIVE files with date 01-01-92;
  373.  
  374.  
  375.  4.3 (De)compressors
  376.  ───────────────────────────────────────────────────────────────────────
  377.  See MTADOCEN.DOC
  378.  
  379.  
  380.  4.4 Encryption and Authenticity
  381.  ───────────────────────────────────────────────────────────────────────
  382.  MTM  is  capable  in  reworking  encrypted  files.  In  this  case, all
  383.  supplied  files  must  have  the  same  password.  You  can  supply the
  384.  password to MTM  with the /IOP  command-line option. MTM  will use this
  385.  password on ALL files it will work on in this run.
  386.  
  387.  MTM  can  handle  PkWare's  Authenticity  Verification.  If  you try to
  388.  delete a AV'ed file (with  /DELFILE) than MTM will ignore  this request
  389.  and leaves the AV'ed file inside the archive.
  390.  
  391.  For  further  details  on  AV  and  Encryption  you  must look into the
  392.  documentation of MTA (MTADOCEN.DOC).
  393.  
  394.  ┌───────┬─────────────────────────────────────────────────────────────┐
  395.  │   5   │ Version information and credits                             │
  396.  └───────┴─────────────────────────────────────────────────────────────┘
  397.  
  398.  5.1 The BETA-team
  399.  ───────────────────────────────────────────────────────────────────────
  400.  See the file SUPPORT.MTA for a full list of beta-testers;
  401.  
  402.  
  403.  5.2 Credits
  404.  ───────────────────────────────────────────────────────────────────────
  405.  See MTADOCEN.DOC
  406.  
  407.  
  408.  5.3 Version history
  409.  ───────────────────────────────────────────────────────────────────────
  410.  ┌───────┬─────────────────────────────────────────────────────────────┐
  411.  │ 15.01 │ Major release                                               │
  412.  └───────┴─────────────────────────────────────────────────────────────┘
  413.   ■ Added  /TOUCHxxx  options  to  touch  archives  based  on  the   MTA
  414.     algorithm (low,  high and  current) and  also with  a specific  date
  415.     (TOUCHNEW);
  416.  
  417.   ■ Fixed a problem with the addition of comments in ARJ files;
  418.  
  419.  ┌───────┬─────────────────────────────────────────────────────────────┐
  420.  │ 15.02 │ Version release                                             │
  421.  └───────┴─────────────────────────────────────────────────────────────┘
  422.   ■ Documentation did not include the special mark before the changes;
  423.  
  424.  ┌───────┬─────────────────────────────────────────────────────────────┐
  425.  │ 15.05 │ Minor Release                                               │
  426.  └───────┴─────────────────────────────────────────────────────────────┘
  427.   ■ MTM would include (and touch) some of its own internal files. This
  428.     is fixed;
  429.  
  430.   ■ MTM will now also include SFX-files (archives with extensions EXE
  431.     or COM) for most of the functions because the original archivers
  432.     (and no internal routines) are now used to update these SFX-file;
  433.  
  434.  ┌───────┬─────────────────────────────────────────────────────────────┐
  435.  │ 15.06 │ Minor Release                                               │
  436.  └───────┴─────────────────────────────────────────────────────────────┘
  437.   ■ Part of the header (copyrights) was trucated. Fixed;
  438.  
  439.  ┌───────┬─────────────────────────────────────────────────────────────┐
  440.  │ 15.07 │ Minor Release                                               │
  441.  └───────┴─────────────────────────────────────────────────────────────┘
  442.   ■ Files that are manipulated will get their ORIGINAL attributes as
  443.     they were at startup (so the ARCHIVE bit is NOT set);
  444.  
  445.  ┌───────┬────────────────────────────┐
  446.  │ 15.08 │ Bug (?) Release            │
  447.  └───────┴────────────────────────────┘
  448.   ■ Reports got in  from  users about MTM in a OS/2 2.0ß DOS box. MTM is
  449.     not able to find any file that the  user wants to select. This nasty
  450.     problem *looks*  like a problem with OS/2 2.0 because the normal DOS
  451.     (ALSO IBM PC-DOS 5.0) works fine and the problems  involved  have to
  452.     do with DOCUMENTED interrupts and NORMAL  Turbo  Pascal  processing.
  453.     Thanks to some willin beta-testers I was able  to track the  problem
  454.     down. This release contains a work-around that even causes MTM to be
  455.     somewhat smaller and still giving the same functions. Under OS/2 2.0
  456.     DOS boxes it *should* work again (as it did with beta-testers). Look
  457.     into HELP__ME.MTA for questions about OS/2 2.0ß because  I don't run
  458.     this operating system and must rely on the input from users who do !
  459.  
  460.  ┌───────┬─────────────────────────────────────────────────────────────┐
  461.  │ 15.10 │ Version Release                                             │
  462.  └───────┴─────────────────────────────────────────────────────────────┘
  463.   ■ Only version number is changed;
  464.  
  465.  
  466.  MTM is tested with PKWare PKPAK release 3.61, PKWare ZIP release  1.10,
  467.  PKWare ZIP release 1.93, NoGate PAK release 2.51, ARC release 6.02  and
  468.  ZOO release  2.10, DWC  release 5.10,  LHarc release  1.13c/d/213, LARC
  469.  release 3.33, ARJ version 2.30 and HYPER version 25.
  470.  
  471.  
  472.  5.4 Copyrights, Trademarks
  473.  ───────────────────────────────────────────────────────────────────────
  474.  PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  475.  PAK           is a trademark of NoGate Consulting.
  476.  ARC           is a trademark of SEA inc.
  477.  ZOO           is a trademark of R. Dhesi.
  478.  DWC           is a trademark of Dean W. Cooper
  479.  LZH and LHarc are trademarks of Yoshi;
  480.  LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
  481.  ARJ           is a trademark of Robert K. Jung
  482.  HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
  483.  4Dos          is a trademark of Rex Conn and JP software
  484.  OS/2          is a trademark of International Business Machines (IBM)
  485.  PC-DOS        is a trademark of International Business Machines (IBM)
  486.  
  487.  MTM is written  in Turbo Pascal  6.0, with help  of the Turbo  Debugger
  488. │2.5 and  makes extensive  use of  Object Professional  1.14 and OPCFI V
  489. │15.01.  Also  a licensed commercial  version of Strg  6.1 was used  and
  490. │the TP 6.0 SYSTEM.TPU was  replaced with a licensed commercial  version
  491. │of SYS60a. Source editing is done with BRIEF 3.1;
  492.  
  493.  Turbo Pascal        is a trademark of Borland International
  494.  Turbo Debugger      is a trademark of Borland International
  495.  Object Professional is a trademark of TurboPower Inc.
  496.  OPCFI               is a trademark of Robert W. van Hoeven
  497.  SYS60               is a trademark of Eagle Performance Software
  498.  STRG61              is a trademark of Eagle Performance Software
  499.  BRIEF               is a trademark of SolutionSystem
  500.  
  501. [=========================== END OF DOCUMENT ==========================]
  502.